home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr36 / msgfax14.zip / MSG2FAX.DOC < prev    next >
Text File  |  1993-05-31  |  8KB  |  193 lines
  1. ──────────────────────────────────────────────────────────────────────────────
  2. MSG2FAX V1.30 - Automatic *.MSG message to fax system.
  3.                 Copyright (c) 1993 Harvey Parisien, FidoNet 1:249/114
  4.                 For custom applications, please netmail.
  5. ──────────────────────────────────────────────────────────────────────────────
  6.  
  7.  ██ Purpose:
  8.  
  9. This utility can be used on any *.MSG type message base.  It scans the message
  10. base for messages that have a subject line that contains a keyword, fax
  11. number, and password.  Example:
  12.  
  13.                     Subj: FAX 1-333-555-1212 password
  14.  
  15. By default if the number is a local number only 7 digits in length, no
  16. password is necessary.  If it is there it is not checked.  Either of these
  17. numbers are 7 digits... 5551212 555-1212 555--1212
  18.  
  19.  
  20.  ██ The message base:
  21.  
  22. SysOps should setup a message area for dealing with faxes.  This can be either
  23. an echomail area or netmail area, as long as it is a *.MSG format message
  24. base.
  25.  
  26. Most users, including Squish users, would find it easier to setup an echomail
  27. type echo called MYFAXES or the like.  NETMAIL areas are just fine, but since
  28. there are many other non fax messages, it will just be a bit slower on older
  29. systems with 1000's of messages.  Otherwise it really doesn't matter.
  30.  
  31. Squish users, just add this line to your squish.cfg file...
  32.  
  33. EchoArea  MYFAXES  C:\max\msg\FAX
  34.  
  35.  
  36.  ██ Your BBS.BAT (or other controlling batch file)
  37.  
  38. In your controlling batch file, right after you process incoming mail, run
  39. MSG2FAX.  If it finds messages with FAX keywords and correct passwords it will
  40. send them out.  If lines are busy, faxes are monitored and sent out next time
  41. MSG2FAX is run, which is the next time you receive email.
  42.  
  43. Example PARTIAL batch file...
  44.  
  45. :MAILin
  46. SQUISH IN OUT SQUASH LINK -fECHOTOSS.LOG
  47. MSG2FAX
  48. GOTO BINKLOOP
  49.  
  50.  
  51.  ██ The config files:
  52.  
  53. 1. MSG2FAX.CFG
  54.  
  55. c:\max\faxtmp
  56. c:\max\msg\myfaxes
  57. c:\fax
  58. c:\max\texts\max.log
  59. NOW
  60. FAXIT.BAT
  61.  
  62. The first 6 lines contain critical data.  All other lines in this
  63. configuration file can be used for comments.
  64.  
  65. The first line is the path for a dedicated working directory where temporary
  66. fax files will be created and launched.  As they are successfully launched,
  67. they will be cleared.  If they are not successfully launched, they will remain
  68. until cleared.  This should be a sub directory ONLY for this process, since
  69. the system will check if it is empty to determine certain processing logics.
  70.  
  71. The second line is the path to your *.MSG files.  This is the message base
  72. described earlier on in this document.
  73.  
  74. The third line is the path to your FAX software, and where your batch file
  75. called SENDFAX.BAT is located.  The system will goto this directory for
  76. processing and then return to it's original position.
  77.  
  78. The fourth line is the path and name of your system activity log.  I have my
  79. MAXIMUS and BINKLEY logs using the same name, and use this for all my
  80. processors that maintain logs.  You might want to do the same, or have a
  81. separate fax.log.
  82.  
  83. The fifth line is a control command which should be NOW or WAIT.  NOW causes
  84. the system to send the fax as it is received.  WAIT causes the system to wait
  85. until you choose to run FAXIT.BAT (a batch file created by msg2fax) in a
  86. future event under your own control.  See info below re NOW or WAIT.
  87.  
  88. The sixth line is a user definable batch file which MSG2FAX will spawn. This
  89. batch file is user definable so you can define a DOS FAXIT.BAT or OS/2
  90. FAXIT.CMD file name.  If you intend on processing under OS/2 with the .CMD
  91. file, use the WAIT command as described above, and issue the os/2 commands
  92. outside of this process.  This batch file will contain the following structure
  93. for each fax in the outbound que:
  94.  
  95. @call SENDFAX c:\max\faxtmp\26175759.3 555-1212
  96.  
  97. One line for each fax calls your batch file SENDFAX.bat (or SENDFAX.CMD) with
  98. 2 command line parameters of drive:\path\faxname.ext and fax phone number.
  99. Make sure your SENDFAX.BAT file is on your fax directory as described in line
  100. 3 above.
  101.  
  102. Your batch file SENDFAX might look like this.  It is important that you check
  103. your fax software for an errorlevel (or use some other means of checking) to
  104. see if the fax was infact sent out.  If it was, then delete the fax in the fax
  105. temporary directory.  Example SENDFAX.BAT for a ZyXel setup:
  106.  
  107. @ZFAX 1 %1 %2
  108. @if not errorlevel 1 del %1
  109.  
  110. See sample sendfax.bat in original archive.
  111.  
  112. 2. MSG2FAX.PWD (not required for local faxes ie 7 digit numbers)
  113.  
  114. Format is NAME,PASSWORD
  115.  
  116. Example:
  117.  
  118. Jim Smith,Apples
  119. Steve Martin,Chair
  120.  
  121. If Jim Smith enters a message with a subject line of...
  122. FAX 1-416-555-1212 APPLES
  123. ... the system will convert the message body to a fax and send it in
  124. this format...
  125.  
  126. _ _ _ O_/_ _C_U_T_ _H_E_R_E_ _ _ _ _ _ _
  127.       O \
  128.  DATE: 23 Aug 92  16:38:49
  129.  FROM: Harvey Parisien
  130.    TO: Steve Martin
  131.   FAX: 555-1212
  132. ──────────────────────────────────────────────────────────────────────────────
  133. Thanks for the invite.  We should arrive at around 7:pm your time.
  134.  
  135. Regards...
  136.  
  137. ──────────────────────────────────────────────────────────────────────────────
  138. MSG2FAX v1.30 - Automated EMAIL to FAX, by Overerx Inc @ 1:249/114
  139. _ _ _ O_/_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
  140.       O \   C U T   H E R E
  141.  
  142.  
  143.  ██ Fax Header File
  144.  
  145. If you have a file named MSG2FAX.HDR, each fax will contain the contents
  146. of this header file at the beginning.  Here's my header file for an example:
  147.  
  148.  
  149. _ _ _ O_/_ _C_U_T_ _H_E_R_E_ _ _ _ _ _ _
  150.       O \
  151.                                     F A X
  152.  
  153.                                  OVERERX INC
  154.                               Box 323 Station A
  155.                               Kingston, Ontario
  156.                                Canada  K7M 6R2
  157.                              FAX: (613) 634-6125
  158. ──────────────────────────────────────────────────────────────────────────────
  159. _ _ _ O_/_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
  160.       O \   C U T   H E R E
  161.  
  162.  
  163.  ██ Advanced notes...
  164.  
  165. NOW or WAIT:  If you want to control sending faxes in your event processing,
  166. use the WAIT command in your configuration file (see above for detail).  In
  167. your batch processing, you should check for the existance of faxit and then
  168. run it.  You should also check for files on your dedicated fax directory and
  169. if none exist, delete faxit.bat to avoid continual processing of that batch
  170. file.  Basically, every fax that comes along gets appended to faxit.bat (or
  171. your user defined batch file name - see above) for processing.  Until the
  172. working fax directory is empty, all faxes in the faxit.bat are processed.
  173. Sendfax.bat checks if it's there and processes it if it is and deletes it when
  174. it's successfully sent. So if your working fax directory is empty, then the
  175. current faxit.bat file can be deleted and save some processing time.
  176.  
  177. This is all handled internally if you use the NOW command and is something you
  178. should never have to worry about or know.  However, if you plan to use the
  179. WAIT command and handle processing yourself, you should understand this
  180. concept.
  181.  
  182. Here's an example of manual processing for setups using the WAIT command...
  183.  
  184. IF EXIST FAXIT.BAT FAXIT
  185. IF EXIST FAXIT.BAT IF NOT EXIST C:\TMPFAXES\*.* DEL FAXIT.BAT
  186.  
  187. ──────────────────────────────────────────────────────────────────────────────
  188. Please use the enclosed registration form and register.
  189.  
  190. Thanks...
  191. ──────────────────────────────────────────────────────────────────────────────
  192. MSG2FAX v1.30 - Automated EMAIL to FAX, by Overerx Inc @ 1:249/114
  193.